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GENERAL NOTES 


This section contains suggestions on getting FLEX™ 9.0 up on your system 
and on compatibility with your existing hardware and software. This 
manual assumes you already have a working disk system and are familiar 
with the basics of floppy disk systems such as proper disk handling 
techniques, inserting and removing disks from the drives, etc. 


One important point should be made in regard to getting FLEX "up and 
running". You receive only one disk and it is crucial that you protect 
this disk with your life. If you take the following steps, you might 
save yourself a lot of headaches and additional expense: 


1) Write-protect the FLEX disk before you ever insert it into a drive. 
Consult your disk system hardware manual or the FLEX User's Manual 
for details on write-protecting a disk. 


2) Boot up the FLEX system and once running copy all files from the 
original FLEX disk to a new disk. Next perform a LINK command to 
FLEX.SYS on this new disk. 


3) Now remove the original FLEX disk and store it in a safe place. It 
should never be used again unless you wipe out all the new FLEX 


disks you make and need to repeat this procedure. Use the new FLEX 
disk you have made for all future ‘3k work. 


FLEX™ is a trademark of Technical Systems Consultants, Inc. 
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HARDWARE REQUIREMENTS 


This section discusses the hardware requirements for running- FLEX 9.0. 
This version is setup for the Southwest Technical Products, Inc.'s disk 
Systems, the MF-68 mini floppy and DMA full size floppy. 


Memory Requirements 


The FLEX disk operating system itself resides in the range of hex C000 
to DFFF. This means you will need 8K of memory starting at $C000. You 
should be certain your particular system can accept memory in this 
region. 


You must also have “User Memory" (RAM) starting at location 0000 hex and 
running continuously up from there. The more user memory you have in 
your system the better off you will be. This is because you will be 
able to run larger programs and because software which works with files 
that are larger than memory can hold (such as the editor or sort/merge) 
will operate more efficiently and quickly. Although FLEX resides at 
$C000, certain of its commands utilize the lower end of this user RAM 
space.: A minimum of 12K of RAM is required for such purposes. 


Monitor ROM 


As sold, this version of FLEX requires the S-BUG monitor ROM from SWTPc 
(or equivalent). FLEX 9.0 has its own internal terminal 1/0 routines, 
so S-BUG's are not used. These routines assume an ACIA at location 
SE004 (port #1). S-BUG is required, however, f^~ setting up interrupt 
vectors. 


There are two exceptions to this ROM requirement. The first is that the 
interrupt vectors need not be set if printer spooling will not be used. 
Thus if you did not require printer spooling you would not require any 
monitor ROM at all (except for booting the system up and to jump to when 
exiting FLEX). The second exception is to make use of the user 
adaptable version of FLEX which is supplied on disk along with the 
Standard version. See ‘Adapting FLEX to Custom Monitors' for details. 


Printer Spooling 


FLEX 9.0 supports ‘printer spooling’ which allows you to list a file (or 
files) on the line printer at the same time as you continue to perform 
other FLEX operations such as editing, assembling, running BASIC, etc. 
In order to do this, FLEX requires a SWTPc MP-T interrupt timer board on 
1/0 port #4. This board is optional, but printer spooling will not 
function without it. Note again that you must also have settable 
sh al vectors (as does S-BUG) in order for printer spooling to 
unction. 
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DISK COMPATIBILITY 


Disks created under 6809 FLEX 9.0 are compatible with those created 
under 5800 FLEX 1.0 on the 8" drives or 6800 FLEX 2.0 on the 5" drives. 
The reverse is also true, meaning that FLEX 9.0 can read disks created 
by one of those 6800 FLEX systems. This means that transferring text 
files will require nothing more than copying with the COPY command. In 
fact it is not even necessary to put the files on a new disk. As long 
as a disk is being used for work files only (no disk command files) it 
may be used interchangeably. 


The one place where the disks are different is in the bootstrap loader 
which the NEWDISK command places on track O when a disk is initialized. 
Obviously the loader must be different for 6800 and 6809. This simply 
means that a disk initialized with the 6809 NEWDISK command cannot be 
used to boot 6800 FLEX and vice versa. 


The new double-density system is an exception to all the above. It 
cannot be used to read disks created by the original 6800 single-dens ity 
system. Any disks, however, created as single-density with the new 
double-density version of NEWDISK (done by answering 'N' to the prompt 
'Double-Sided Disk?') can be read on either a single or double density 
system. This is because the new double-density NEWDISK writes FF's in 
certain gap areas whereas the old single-density NEWDISK wrote 00's. 
SRH, The single-density controller board (which uses the Western Digital 


se 1771) can read either type, but the double-density board (which uses the 
Western Digital 1791) can only read the type with FFs. 


SOFTWARE COMPATIBILITY 


6809 object code is NOT at all compatible with 6800 object code. This 
means you cannot run binary command files from a 6800 system on a 6809 
system. Since 6809 FLEX can read a 6800 FLEX disk and vice versa, you 
must be careful not to execute a 6800 command in a 6809 system and 
again, vice versa. 


Where the 6809 and 6800 ARE compatible is in the source code. Thus, if 
you have the source listing for a 6800 program on disk, it can be 
reassembled by the 6809 assembler to produce executable 6809 object 
code. Of course if the program calls any routines from FLEX, these 
addresses will have to be changed since 6809 FLEX resides at $C000 (6800 
FLEX is at $A000). This is usually a matter of simply changing all 
occurrences of '$A' to '$C' and all '$B' to '$D' with the editor. 
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ADAPTING FLEX 


The FLEX 9.0 disk supplied has two copies of the FLEX object: code. One 
is called FLEX.SYS and is ready to boot up with SWTPc disk hardware. 
The second is called FLEX.COR which represents the CORe or main body of 
PLEX. It differs from the bootable form of FLEX in that it does not 
have any terminal or disk I/O routines built in. This allows the user 
to modify these I/0 drivers, if desired, to produce a customized version 
of FLEX. Note that in order to produce this customized version you must 
have FLEX up and running so you will need the bootable version 
(FLEX.SYS). The customized terminal and disk I/0 routines are supplied 
in two packages. We will discuss them separately and then examine how 
to add them onto FLEX.COR to produce a new, customized, bootable version 
of FLEX. 


The CUSTOM I/0 DRIVER PACKAGE 


This package allows the user to alter the functioning of the terminal 
1/0 and the functioning of printer spooling. Nine routines and two 
interrupt vectors are set up in this package. There is a space reserved 
for these routines beginning at location $D370 and ending at $D3E6. The 
address of these 11 items must be setup in a jump table found at 
locations $D3E7 thru $D3FB. A copy of the Custom I/0 Driver Package 
used to produce FLEX.SYS is included at the end of the General Notes 
section. Use it as a guide for writing your own. 


A description of each routine and vector follows. 


INCH 

The address of the input character routine should be placed at $D3FB. 
This routine should get one input character from the terminal and return 
it in ‘A' with .the parity bit cleared. It should also echo the 
character to the output device. Only 'A' and the condition codes may be 
modified. 


OUTCH 
The address of the output character should be placed at $D3F9. This 


routine should output the character found in 'A' to the output device. 
No registers should be modified except condition codes. 


STAT 

The address of the STAT routine should be placed at $D3F7. This routine 
checks the status of the input device. That is to say, it checks to see 
if a character has been typed on the keyboard. If so, a Not-Equal 
condition should be returned. If no character has been typed, an Equal 


to zero condition should be returned. No registers may be modified 
except condition codes. 


TINIT = 


The address of the terminal initialization routine should be placed at 
$D3F5. This routine performs any necessary initialization for terminal 
I/0 to take place. Any register may be modified except 'S'. 


ae 


Paley 


FLEX General Notes 


MONITR 


This is the address to which execution will transfer when FLEX is 
exited. It is generally the reentry point of the system's monitor ROM. 
The address should be placed at $D3F3. 


TMINT 
The address of the timer initialization routine should be placed at 
$D3F1. This routine performs any necessary initialization for the 


interrupt timer used by the printer spooling process. Any register may 
be modified except ‘S'. 


TMON 

The address of the timer on routine should be placed at $D3EF. This 
routines "turns the timer on" or in other words starts the interval IRQ 
interrupts. Any registers execpt 'S' may be modified. 


TMOFF 


The address of the timer off routine should be placed at $D3ED. This 
routine "turns the timer off" or in other words stops the interval IRQ 
interrupts. Any registers except 'S' may be modified. 


IRQVEC 

The IRQ vector is an address of a two byte location in RAM where FLEX 
can stuff the address of its IRQ interrupt handler routine. In- other 
words, when an IRQ interrupt occurs control should be transferred to the 
address stored at the location specified by the IRQ vector. This IRQ 
vector location (address) should be pla-~+ at $D3EB. 


SWIVEC 


The SWI3 vector is an address of a two byte location in RAM where FLEX 
can stuff the address of its SWI3 interrupt handler routine. In other 
words, when an SWI3 interrupt occurs control should be transferred to 
the address stored at the location specified by the SWI3 vector. This © 
SWI3 vector location (address) should be placed at $D3E9. 


IHNDLR 

The Interrupt Handler routine is the one which will be executed when an 
IRQ interrupt occurs. If using printer spooling, the routine should 
first clear the interrupt condtion and then jump to the ‘change process' 
routine of the printer spooler at $C700. If not using printer spooling, 
this routine can be setup to do whatever the user desires. If it is 
desirable to do both printer spooling and have IRQ's from another device 
(besides the spooler clock), this routine would have to determine which 
device had caused the interrupt and handle it accordingly. The address 
of this routine should be placed at $D3E7. 
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The CUSTOM DISK DRIVER PACKAGE 


This package supplies all the disk functions required by FLEX. There 
are eight routines in all: : 


READ Reads a single sector 

WRITE Writes a single sector 

VERIFY Verifys a single sector 

RESTORE Restores the head to track 0 

DRIVE Selects the desired drive 

CHECK Checks a drive for a ready condition 
QUICK Same as CHECK but with no delay 

INIT Initializes any necessary values 
WARM Does any Warm Start initialization 


These routines and what is required of them are decribed in the Advanced 
Programmer's Guide in the section titled ‘DISK DRIVERS'. There is a 
jump table which contains the address of all these routines at $DE0O. 
This table is as follows: 


DEOO JMP READ 
DEO3 JMP WRITE 
DE06 JMP VERIFY 
DEOS JMP RESTOR 
DEOC JMP DRIVE 
DEOF JMP CHECK 
DE12 JMP QUICK 
DE15 JMP INIT 
DE18 JMP WARM 


Immediately following this jump table there is a space for the disk 
driver routines. In the general case this space would start at $DE1B 
and run through $DFFF. In the SWTPc system with S-BUG installed, that 
entire space is not available due to the fact that S-BUG uses RAM in the 
area of $DFAO to $DFFF for variables and stack. Thus the driver routine 
area is limited in this case to $DE18 through $DF9F. 


The actual source listings for the SWTPc drivers are not included, but a 
skeletal Custom Disk Driver Package is included at the end of this 
section which should assist you in writing your own package. 


PUTTING THE CUSTOM FLEX TOGETHER 


Once you have written and assembled a Custom 1/0 and Custom Disk Driver 
packages, you are ready to append them to the core of FLEX (FLEX.COR) to 
produce a new, bootable version. This is done with the APPEND utility 
if FLEX, but before we get into that there is a very important point 
which must be covered. 


xak. IMPORTANT *** 
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The copy of FLEX on disk is much like any other standard binary file. 
IT MUST HAVE A TRANSFER ADDRESS IN ORDER TO WORK! It is also important 
to note that unlike other binary files FLEX can have ONLY ONE transfer 
address and it MUST BE THE LAST THING IN THE FILE! The simplest way of 
getting that transfer address into the file is by use of the END 
statement in the assembler. We recommend you put a transfer address on 
the END statement of the Custom I/0 Driver Package and make sure it is 
the last thing in the final FLEX file. 


Assuming you have put a transfer address on the Custom 1/0 Driver 
Package with an end statement of the form: 


END $CD00 


you can now create a new version of FLEX by appending the custom disk 
drivers and custom 1/0 drivers onto FLEX.COR. You should use the APPEND 
command for this purpose as shown: 


+++APPEND FLEX.COR DRVRS.BIN CUSTOMIO.BIN NEWFLEX.SYS 


This command assumes the object file you created for the Custom Disk 

Drivers is called DRVRS.BIN and the Custom 1/0 Drivers are in a file 

called CUSTOMIO.BIN. The new, custom version of FLEX is called 

NEWFLEX.SYS. In order to boot up this NEWFLEX.SYS you must link it with 

the LINK command (see the FLEX User's and Advanced Progammer's Manuals). 
eae The command would be of the form: 


+++LINK NEWFLEX.SYS 


The disk containing your newly made and linked FLEX can now be booted 
with the normal boot procedure. 
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